This directory contains the source to make versions of OpenLook pi and rtpi for
a Sun3(m68k), Sun4(sparc), Silicon Graphics 4-D Series(Mips), or PCs based
on Intel 80386s. To compile pi you will need a C++ compiler. The code has been
compiled and tested with the following releases of operating systems and
compilers:

	C++:	release 3.0
	SunOS:	release 4.X (Sparc and Sun3)
		release 5.X (Sparcs with gcc 2.3.3 and SPARCompiler 2.0.1)
	IRIX:	release 4.0.5 (SGI Versions)
	AT&T Unix SysV: release 3.2.[2 or 3] (i386 Versions)

There are 5 subdirectories where binaries are made for the different
versions of pi and rtpi:

	pi.sun3
	pi.sun4
	pi.sunos5
	pi.sgi
	pi.i386

This setup allows a single copy of the source, mounted on the
various architectures with NFS, to be used for all systems.
Hardlinks are created from files in this directory to each of the
subdirectories, as some versions of make don't permit template
rules with dependents in different directories.
Each subdirectory contains a Makefile that can be used to build
the appropriate system.  These makefiles automatically determine
include file dependencies if you type "make depend".  If you modify code,
do it in this directory.  Adding new files will require modification
to the Makefile in this directory and the Makefiles in all the
subdirectories that use the new file. The Makefile in this directory
serves as a front end to the subdirectory Makefiles.

The real-time remote debugging version can be used to debug
both real-time applications and operating system kernels.
It has been used to debug Unix kernels, a real-time
multitasking executive (NRTX) and its applications, and
programs running on bare processors (no operating system).
The remote debugging system supports members of the Motorola
68000 family, WE32X00 processors, and the DSP32C.
To use the remote debugging version need at least one the following
packages:
	real-time debug monitors
	NRTX operating system
	Unix servers
Contact me if you need these.

To construct pi, do the following:

	in the following ARCH is one of sun[34], sunos5, sgi, i386

	1) Make pads library
	   (cd ../pads/host; make -f MakeARCH)

	2) Make help text files - you will probably need to edit help/Makefile
	   to tell it where AT&T nroff with -mm macros resides.
	   make help;

	2) Make pi binary
	   make ARCHpi;

To make pads:

	1) (cd ../pads/openlook; make -f Make.ARCH)
	   This requires that you have the OpenLook toolkit with some
	   special fixes in the TextEdit widget.

To construct rtpi the directions are the same as pi except:

	1) You will first need to make the rt host library. This code
	   is part of the debug monitor code and is shipped separately from
	   pi. To make it:
	   (cd whereinstalled/rt8/host; make -f Make.ARCH)

	2) To make rtpi, edit the RTLIB variable in the file pi.ARCH/Makefile
	   to the location of the new rt host library. Then type:
	   make ARCHrtpi

	If you discover bugs, please let me know.

	Dave Kapilow
	(908) - 582 -3596
	research!dak
